iT邦幫忙

2024 iThome 鐵人賽

DAY 10
0
Software Development

Go語言設計與架構之美系列 第 10

Day 10 - Interface的使用技巧

  • 分享至 

  • xImage
  •  

這篇文章要來聊聊如何運用Interface改善我們的程式專案,換句話說,我們講的是Go語言中interface的使用模式和習慣。

首先得強調一點,那就是「適度封裝」。換句話說,我們不是為了封裝而封裝。我們之前提到過,接口其實就是一種封裝的手段,主要目的是為了解耦。所以,重點是我們應該在真正需要的時候才使用接口。

大部分情況下,接口都能對應用設計帶來好處。但如何恰當地使用interface來優化我們的程式設計呢?這就要從Go語言的「組合」設計哲學說起了。

一切皆組合

Go語言的創始人Rob Pike有句名言:如果說C++和Java是講究類型層次和分類的語言,那Go語言則是專注於組合的語言。想像Go應用就像一台機器,組合的藝術就在於如何把分散於各個包中的零件有效組合起來。這是Go的核心設計理念之一,而「正交性」則讓這種設計更加方便實現。

所謂正交性,其實是個幾何學上的概念,意指兩條直線在直角交會。在程式設計中,這表示兩個或多個元素之間的相互獨立,互不影響。這種設計使得當一個元素改變時,不會牽連到其他元素。

垂直組合

在傳統的面向對象語言中,如C++,通常透過繼承來建立一個類型體系。但在Go語言中,我們不使用繼承,而是採用「組合」來賦予單一類型更多的功能,這種方法有點類似於硬體升級時的垂直擴充。因為這不涉及繼承,所以新類型與被嵌入的類型之間不存在「父子關係」,它們之間的關聯僅由方法名來決定。更多關於垂直組合(繼承)可以參考我之前寫的這篇文章Method: 怎麼用變數模擬繼承

水平組合

當通過垂直組合確立了類型之後,我們如何將這些獨立的component連結成一個完整的應用呢?來看一個具體的例子:

假設我們要寫一個函數,負責把數據寫到硬碟上:

func Save(f *os.File, data []byte) error

上面函數用*os.File來定位數據要寫入的目標。但這樣設計有幾個問題。首先,它很難進行測試,因為*os.File涉及到實際的file descripter,我們必須操作實體文件來測試這個函數,這非常不方便。

其次,Save函數直接指定*os.File最為參數型態限制了它的可擴充性。如果我們想改為向網路儲存寫數據,就必須修改這個函數的參數型態,這會影響到所有使用這個函數的程式碼。

那麼,如何改進Save函數的設計呢?我們可以嘗試使用interface。以下是新版Save函數的原型:

func Save(w io.Writer, data []byte) error

這裡,我們用io.Writer接口替代了*os.File。這種設計遵循了interface分離的原則,因為io.Writer只包含一個Write方法,恰恰是Save函數所需要的。

如此一來,新版的Save函數不僅可以向硬碟寫入數據,也能向網路儲存(NAS)寫入數據,並支持任何實現了Write方法的類型,這大大提升了其可擴充性。而且,這也使得測試變得簡單,只需使用bytes.NewBuffer創建一個*bytes.Buffer,傳入Save函數,完成測試後比對數據即可。

Interface的其他設計模式

Go語言中有幾種常見的接口設計模式:

工廠模式

這種模式在原生的Library sync、log和bufio中都有使用。以log中的New函數為例:

type Logger struct {
    mu     sync.Mutex
    prefix string
    flag   int
    out    io.Writer
}

func New(out io.Writer, prefix string, flag int) *Logger {
    return &Logger{out: out, prefix: prefix, flag: flag}
}

包裝器模式

這種模式用於對輸入數據進行過濾或變換。一個典型的例子是Go標準庫io中的LimitReader函數:

func LimitReader(r Reader, n int64) Reader { 
    // Do something
    reader := &LimitedReader{r, n}
    // Do something
    return reader 
}

type LimitedReader struct {
    R Reader
    N int64
}

func (l *LimitedReader) Read(p []byte) (n int, err error) {
    // ...
}

LimitReader是一個新的Reader,在init io.Reader前後對Read函數做客製化包裝。

適配器模式

這種模式的核心是適配函數的類型轉換。最常見的例子是http.HandlerFunc

func greetings(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Welcome!")
}

func main() {
    http.ListenAndServe(":8080", http.HandlerFunc(greetings))
}

這個例子展示了怎麼透過 http.HandlerFunc 這個適配器函數類型,將一般的 greetings 函數迅速轉換成符合 http.Handler interface的類型。在 Go 語言的 http Library中,http.HandlerFunc 的定義如下所示:

// $GOROOT/src/net/http/server.go
type Handler interface {
    ServeHTTP(ResponseWriter, *Request)
}

type HandlerFunc func(ResponseWriter, *Request)

func (f HandlerFunc) ServeHTTP(w ResponseWriter, r *Request) {
    f(w, r)
}

經過 HandlerFunc 的適配轉換後,我們可以將其object用作參數,pass給接收 http.Handlerhttp.ListenAndServe 函數,這樣一來,就能夠實現基於interface的組合設計,轉化後greetings就有了ServeHTTP方法。這種設計方式不僅簡化了程式碼的複雜性,也增強了程式的封裝化和可重用性,讓開發者能夠更靈活地應對不同的網路服務需求。

中間件(Middleware)

中間件實質上是結合了包裝模式和適配器模式。看看這個例子:

func validateAuth(s string) error {
    if s != "123456" {
        return fmt.Errorf("%s", "bad auth token")
    }
    return nil
}

func greetings(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Welcome!")
}

func logHandler(h http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        log.Printf("[%s] %q\n", r.Method, r.URL.String())
        h.ServeHTTP(w, r)
    })
}

func authHandler(h http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        err := validateAuth(r.Header.Get("auth"))
        if err != nil {
            http.Error(w, "bad auth param", http.StatusUnauthorized)
            return
        }
        h.ServeHTTP(w, r)
    })
}

func main() {
    http.ListenAndServe(":8080", logHandler(authHandler(http.HandlerFunc(greetings))))
}

這裡的 logHandler 和 authHandler 是中間件,通過適配器函數類型(http.HandlerFunc)將普通函數轉為實現 http.Handler 的類型的object。

總結

  • 了解接口的本質和原則,不為了封裝而封裝。
  • 善用 Go 語言的組合設計哲學。
    • 垂直組合:透過傳統程式語言繼承的方式來垂直增加類型功能。
    • 水平組合:將不同 component 但是共用的Method封裝成一個interface,把這個interface最為參數型態,類似傳統程式語言的多型。
  • 透過Go語言的Interface也能實現各種不同的設計模式。
    • 工廠模式:靈活創建多種類型同個class的object,例如Logger,不同的Logger object主要差別可能就是寫入的路徑,所以創建不同的Logger適合工廠模式。
    • 包裝器模式:增加新功能而不改變原始interface,有點類似Python的decorator可以對class前後進行前置或是後置處理。
    • 適配器模式:轉化函數為特定其他但相同簽名的函數,以適配所需函數的Method實現。
    • 中間件:增加新功能而不改變原始function功能,有點類似Python的decorator可以對function前後進行前置或是後置處理。

更多Go語言相關的文章,歡迎參閱我的部落格: https://kaichiachen.github.io/2024/02/16/golang/interface_usage/


上一篇
Day9 - Interface: 為什麼nil接口不等於nil?
下一篇
Day11 - Go中最強的的魔法: 併發程式執行
系列文
Go語言設計與架構之美30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言